M360 Customer API documentation

Diagnostics Tests Reference (v2 API only)

This document describes all available diagnostics tests that can appear in the diagnosticsResults array of the Customer API V2 getHistory response. Each device session may contain zero or more diagnostics results, and each result contains an array of individual test results.

Response Structure

Diagnostics results are nested in the response as follows:

DeviceSession
  └── diagnosticsResults[]           → DiagnosticsResult objects
        ├── createdAt
        ├── finishedTime
        ├── diagnosticsTemplate
        └── tests[]                  → DiagnosticsResultTest objects
              ├── testId             → Test code (see below)
              ├── result             → "Passed", "Failed", "Skipped", or "NA"
              ├── elapsedTime        → Array of elapsed times in seconds
              └── details[]          → DiagnosticsResultDetail objects
                    ├── context      → Detail context code (see below)
                    ├── title        → Display title of the detail
                    ├── value        → The value of the detail
                    └── result       → "Passed", "Failed", "Skipped", or "NA"

Test Result Values

Each test (and each detail within a test) has a result property with one of these values:

Value Description
Passed The device successfully passed the test
Failed The device failed to pass the test
Skipped The test was skipped by the user
NA The test is not available on the device

Tests by Category

Screen Tests

TouchScreen - Touchscreen

This test is designed to help you test the touchscreen functionality of your device. You can quickly and easily identify any issues, such as dead spots or unresponsive areas.

Possible details:

Context Title Description
TouchTestVersion Version The version of the performed touch test. Possible values: "Full-screen (more precise)", "Lite (fast)"

Multitouch - Multitouch

Use this test to check how accurately your device can detect and respond to multiple touch points on its touchscreen, simultaneously. A common example of a multi-touch is the "pinch-to-zoom" gesture.

Possible details:

Context Title Description
MultitouchDetectedNumberOfTouches Number of touches The number of touches detected by the multitouch test

Color - Dead Pixel

Our pixel test helps you find any malfunctioning pixels on your device's display screen. Dead pixels are pixels that are stuck as a single colour and cannot change. The test will display a series of solid colour images for you to examine, in order to find any pixels that remain in a different colour or appear as a black spot.

This test has no additional details.

Lcd - LCD

Use this test to detect possible LCD display issues. The special 4 colour background and the auto-increasing brightness might help to recognise colour fade, light leakage, light bleeding, horizontal or vertical lines, light or dark patches, dead pixel or bright pixel.

This test has no additional details.

Touch3D - 3D Touch

On supported Apple devices, users can access additional functionality by applying varying levels of pressure to the touchscreen. You can inspect the touch panel's pressure sensitivity with this test. Please note that 3D Touch was discontinued with the iPhone 11 and onwards in favour of Haptic Touch.

This test has no additional details.

SecondaryTouchScreen - Secondary Touchscreen

Touchscreen test for devices with a secondary display (e.g. foldable devices).

Possible details: Same as TouchScreen.

SecondaryMultitouch - Secondary Multitouch

Multitouch test for the secondary display.

Possible details: Same as Multitouch.

SecondaryColor - Secondary Dead Pixel

Dead pixel test for the secondary display.

This test has no additional details.

SecondaryLcd - Secondary LCD

LCD test for the secondary display.

This test has no additional details.

Audio Tests

Speaker - Speaker

Check the functionality of the built-in speakers of your mobile device. This test helps ensure that the audio components are working properly and can be used for tasks such as making phone calls, recording voice memos, or listening to media.

Possible details:

Context Title Description
SpeakerLoud Loud Speaker The result of the loudspeaker test. The value indicates the test mode: "Auto" or "Manual"
SpeakerEar Ear Speaker The result of the ear speaker test. The value indicates the test mode: "Auto" or "Manual"

Microphone - Microphone

Check the functionality of the built-in microphones of your mobile device. This test helps ensure that the audio components are working properly and can be used for tasks such as making phone calls, recording voice memos, or listening to media.

Possible details:

Context Title Description
MicrophoneCamera Camcorder The result of the camera microphone test. The value indicates the test mode: "Auto" or "Manual"
MicrophoneMicrophone Microphone The result of the main microphone test. The value indicates the test mode: "Auto" or "Manual"
MicrophoneTop Top The result of the top microphone test. The value indicates the test mode: "Auto" or "Manual"
MicrophoneBottom Bottom The result of the bottom microphone test. The value indicates the test mode: "Auto" or "Manual"
MicrophoneLeft Left The result of the left microphone test. The value indicates the test mode: "Auto" or "Manual"
MicrophoneRight Right The result of the right microphone test. The value indicates the test mode: "Auto" or "Manual"
MicrophoneBack Back The result of the back microphone test. The value indicates the test mode: "Auto" or "Manual"
MicrophoneFront Front The result of the front microphone test. The value indicates the test mode: "Auto" or "Manual"
MicrophoneNotPredefined (dynamic) The test result of other, found, non-standard microphones. The title contains the name or identifier of the microphone. The value indicates the test mode: "Auto" or "Manual"

Headphones - Headphones

Please connect your headphones to test their functionality and performance.

This test has no additional details.

Device Tests

HardwareButton - Hardware Buttons

This test checks the functionality of the physical buttons on your mobile device by verifying that the device registers if they are pressed.

Possible details:

Context Title Description
HardwareButtonPower Power/Lock The result of the power button test. The value is "Not Tested" if the button was not tested
HardwareButtonVolumeUp Volume Up The result of the volume up button test. The value is "Not Tested" if the button was not tested
HardwareButtonVolumeDown Volume Down The result of the volume down button test. The value is "Not Tested" if the button was not tested
HardwareButtonHome Home The result of the home button test. The value is "Not Tested" if the button was not tested
HardwareButtonMute Mute switch The result of the mute button test. The value is "Not Tested" if the button was not tested
HardwareButtonBixby Bixby The result of the Bixby button test. The value is "Not Tested" if the button was not tested
HardwareButtonAction Action Button The result of the action button test (iPhone 15 Pro and later). The value is "Not Tested" if the button was not tested
HardwareButtonCameraTake Camera Button Hard Press The result of the camera button test (Sony Xperia, iPhone 16). The value is "Not Tested" if the button was not tested
HardwareButtonCameraSlide Camera Button Half Press & Slide The result of the camera slide button test. The value is "Not Tested" if the button was not tested
HardwareButtonNotPredefined (dynamic) The test result of other, found, non-standard hardware buttons. The title contains the name or key code of the button. The value is "Not Tested" if the button was not tested

Battery - Battery

Our drain test measures how quickly the battery of your mobile device is drained while performing various resource-intensive tasks. It can be useful to identify bad batteries that drain too fast and should be replaced.

Possible details:

Context Title Description
BatteryCurrentCapacity Current Capacity The current capacity of the battery in mAh
BatteryOriginalCapacity Original Capacity The original (design) capacity of the battery in mAh
BatteryCycles Battery Cycles The number of charge cycles the battery has gone through
BatteryTemperature Temperature The temperature of the battery in degrees Celsius
BatteryVoltage Voltage The voltage of the battery in mV
BatteryTechnology Technology The technology of the battery (e.g. Li-ion)
BatteryDrainPercentLost Charge lost during drain The percentage of battery capacity lost during the drain test
EstimatedBatteryHealth Battery (Drain) Test Result The estimated health of the battery in percentage
PreciseBatteryHealth OEM Battery Health The precise health of the battery in percentage (reported by the device manufacturer)
BatteryDiagnosticResult Battery Diagnostic Result The result of the battery diagnostic

RearCamera - Rear Camera

This test turns on the rear camera, and displays its view on the screen. You can utilise the provided zoom and focus options (depending on your device) to capture an image and evaluate the camera's functionality.

This test has no additional details.

FrontCamera - Front Camera

During this test, the front camera will activate and its image will be displayed on the screen. You can utilise the provided zoom and focus options (depending on your device) to capture a picture and evaluate the camera's functionality.

This test has no additional details.

Autofocus - Autofocus

To verify the autofocus functionality of the rear camera, point it at a QR code. If it's successfully recognised by the device, the test will pass automatically. If the camera fails to automatically focus on the QR, it suggests a potential defect, and the test should be marked failed.

This test has no additional details.

Flash - Flash

Please make sure that the test has turned on the flashlight by inspecting the back side of the device, where flash LEDs are usually located.

This test has no additional details.

Vibration - Vibration

This test should vibrate your device while it's running. If you cannot feel the vibration then the motor might be defective.

This test has no additional details.

Storage - Storage

This is an overview of the available and used internal storage space in your device.

Possible details:

Context Title Description
StorageTotal Total The total amount of storage on the device
StorageUsed Used The amount of used storage on the device
StorageFree Free The amount of free storage on the device

Pen - Stylus Pen

You can use this test to verify if your device is compatible with a stylus pen or to check the functionality of your stylus pen.

This test has no additional details.

Sensor Tests

Biometric - Biometric Sensor

You can use this test to assess the functionality of the biometric sensor in your device. It requires completing a biometric authentication to verify its effective operation.

Possible details:

Context Title Description
BiometricFaceIdCondition Face ID has passed self-diagnostics The condition of the Face ID biometric sensor (pass indication)
BiometricFaceIdConditionFail Face ID has failed self-diagnostics The reason why the Face ID biometric sensor failed
BiometricFaceIdFaceIdStatus Face ID Status The current status of Face ID. Possible values: "Active", "Inactive", "Preparing", "Unknown"
BiometricFaceIdBracketedCaptureFrame Bracketed Capture Frame Whether bracketed capture frame is available. Possible values: "Yes", "No"
BiometricFaceIdUserEngaged User Engaged Whether the user is engaged. Possible values: "Yes", "No"
BiometricFaceIdUserAttention User Attention Whether user attention is detected. Possible values: "Yes", "No"
BiometricFaceIdFaceOcclusion Face Occlusion Whether face occlusion is detected. Possible values: "Yes", "No"
BiometricFaceIdEyeOcclusion Eye Occlusion Whether eye occlusion is detected. Possible values: "Yes", "No"
BiometricFaceIdSensorTemperature Sensor Temperature The temperature of the Face ID sensor
BiometricFaceIdValidFaceIdFrame Valid Face ID Frame Whether a valid Face ID frame is captured. Possible values: "Yes", "No"
BiometricFaceIdExpressionRecognitionValid Expression Recognition Valid Whether expression recognition is valid. Possible values: "Yes", "No"
BiometricFaceIdMotionDetectionValid Motion Detection Valid Whether motion detection is valid. Possible values: "Yes", "No"

Accelerometer - Accelerometer

Tilt the device to navigate the ball to touch the four borders around it. As each one is touched, they will turn green, indicating a success. Once all borders are green, the test will be passed. If you cannot control the ball properly, there could be a problem with the accelerometer.

This test has no additional details.

Gyroscope - Gyroscope

Perform all described movements with the device to complete the gyroscope test. If you cannot complete every move, the gyroscope might be defective.

This test has no additional details.

Proximity - Proximity Sensor

To perform this test, cover the front of the device near the top with your hand or with an object. If any change is detected from the sensor, the test will pass automatically. If the test does not react to the sensor being covered, the proximity sensor might be defective. Please note: some newer devices feature virtual proximity sensors that would only pass if the device is placed face down.

This test has no additional details.

Light - Light Sensor

Place the phone's front-top side under a bright light source, like a table lamp or another phone's flashlight. If the light sensor works, you should see the lux value and its bar changing.

This test has no additional details.

Magnetic - Magnetic Sensor

Turn (or move) your device around to see if the arrow below responds to changes in direction. If it does, complete the full circle by filling each line. If the compass doesn't respond, there might be an issue with the magnetic sensor or you need to calibrate it first.

This test has no additional details.

Lidar - LiDAR Scanner

This test activates the LiDAR scanner and its image will be displayed on the screen. LiDAR uses lasers to create detailed models of the surrounding environment by measuring distances with light pulses. If the scanner is working fine, you should see a black & white, depth sensitive image of your surrounding.

This test has no additional details.

Connectivity Tests

Call - Call

Please enter a local phone number into the field provided and click the button to initiate a call, thereby testing the calling capability of your device. This test can only work if a working SIM card is present in the device.

This test has no additional details.

Charge - Charge

This test is designed to determine whether your device can be effectively charged using a USB cable, a wireless charger, or a wall (AC) charger.

Possible details:

Context Title Description
ChargeWired Wired The result of the wired charging test. The value is "Not Tested" if this charging method was not tested
ChargeWireless Wireless The result of the wireless charging test. The value is "Not Tested" if this charging method was not tested
ChargeAc AC The result of the AC charging test. The value is "Not Tested" if this charging method was not tested
ChargeUsb USB The result of the charging test through the USB port. The value is "Not Tested" if this charging method was not tested
ChargeDock Dock The result of the charging test through the dock port. The value is "Not Tested" if this charging method was not tested

Wifi - WiFi

This test can instantly verify if your device's WiFi is working, as long as it is turned on.

This test has no additional details.

Bluetooth - Bluetooth

This test can instantly verify if your device's Bluetooth is working if it's turned on.

This test has no additional details.

Gps - GPS

This test will attempt to read the device's GPS coordinates and locate your position on the map. If the pin on the map shows a different location than where you are, the GPS chip might be defective.

This test has no additional details.

Nfc - NFC

Please position the device in close proximity to an NFC tag, card, or device, ensuring that the NFC reader, typically located on the back side of the device, is in contact. The test will automatically pass once NFC detection is confirmed.

This test has no additional details.

Quick Reference: All Test IDs

testId Name Category
TouchScreen Touchscreen Screen
Multitouch Multitouch Screen
Color Dead Pixel Screen
Lcd LCD Screen
Touch3D 3D Touch Screen
SecondaryTouchScreen Secondary Touchscreen Screen
SecondaryMultitouch Secondary Multitouch Screen
SecondaryColor Secondary Dead Pixel Screen
SecondaryLcd Secondary LCD Screen
Speaker Speaker Audio
Microphone Microphone Audio
Headphones Headphones Audio
HardwareButton Hardware Buttons Device
Battery Battery Device
RearCamera Rear Camera Device
FrontCamera Front Camera Device
Autofocus Autofocus Device
Flash Flash Device
Vibration Vibration Device
Storage Storage Device
Pen Stylus Pen Device
Biometric Biometric Sensor Sensors
Accelerometer Accelerometer Sensors
Gyroscope Gyroscope Sensors
Proximity Proximity Sensor Sensors
Light Light Sensor Sensors
Magnetic Magnetic Sensor Sensors
Lidar LiDAR Scanner Sensors
Call Call Connectivity
Charge Charge Connectivity
Wifi WiFi Connectivity
Bluetooth Bluetooth Connectivity
Gps GPS Connectivity
Nfc NFC Connectivity

Quick Reference: All Detail Contexts

Context Code Display Name Parent Test
BatteryCurrentCapacity Current Capacity Battery
BatteryCycles Battery Cycles Battery
BatteryDiagnosticResult Battery Diagnostic Result Battery
BatteryDrainPercentLost Charge lost during drain Battery
BatteryOriginalCapacity Original Capacity Battery
BatteryTechnology Technology Battery
BatteryTemperature Temperature Battery
BatteryVoltage Voltage Battery
BiometricFaceIdBracketedCaptureFrame Bracketed Capture Frame Biometric
BiometricFaceIdCondition Face ID has passed self-diagnostics Biometric
BiometricFaceIdConditionFail Face ID has failed self-diagnostics Biometric
BiometricFaceIdExpressionRecognitionValid Expression Recognition Valid Biometric
BiometricFaceIdEyeOcclusion Eye Occlusion Biometric
BiometricFaceIdFaceIdStatus Face ID Status Biometric
BiometricFaceIdFaceOcclusion Face Occlusion Biometric
BiometricFaceIdMotionDetectionValid Motion Detection Valid Biometric
BiometricFaceIdSensorTemperature Sensor Temperature Biometric
BiometricFaceIdUserAttention User Attention Biometric
BiometricFaceIdUserEngaged User Engaged Biometric
BiometricFaceIdValidFaceIdFrame Valid Face ID Frame Biometric
ChargeAc AC Charge
ChargeDock Dock Charge
ChargeUsb USB Charge
ChargeWired Wired Charge
ChargeWireless Wireless Charge
EstimatedBatteryHealth Battery (Drain) Test Result Battery
HardwareButtonAction Action Button HardwareButton
HardwareButtonBixby Bixby HardwareButton
HardwareButtonCameraSlide Camera Button Half Press & Slide HardwareButton
HardwareButtonCameraTake Camera Button Hard Press HardwareButton
HardwareButtonHome Home HardwareButton
HardwareButtonMute Mute switch HardwareButton
HardwareButtonNotPredefined (dynamic) HardwareButton
HardwareButtonPower Power/Lock HardwareButton
HardwareButtonVolumeDown Volume Down HardwareButton
HardwareButtonVolumeUp Volume Up HardwareButton
MicrophoneBack Back Microphone
MicrophoneBottom Bottom Microphone
MicrophoneCamera Camcorder Microphone
MicrophoneFront Front Microphone
MicrophoneLeft Left Microphone
MicrophoneMicrophone Microphone Microphone
MicrophoneNotPredefined (dynamic) Microphone
MicrophoneRight Right Microphone
MicrophoneTop Top Microphone
MultitouchDetectedNumberOfTouches Number of touches Multitouch
PreciseBatteryHealth OEM Battery Health Battery
SpeakerEar Ear Speaker Speaker
SpeakerLoud Loud Speaker Speaker
StorageFree Free Storage
StorageTotal Total Storage
StorageUsed Used Storage
TouchTestVersion Version TouchScreen